home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Games / NetHack 3.1.3 / source / sys / mac / Install.mpw < prev    next >
Encoding:
Text File  |  1993-08-01  |  4.7 KB  |  104 lines  |  [TEXT/R*ch]
  1. How to make Mac NetHack 3.1 using MPW
  2. Copyright (c) 1992-11-23 Jon W{tte
  3.  
  4.  
  5. Please read these instructions through carefully before starting to
  6. build NetHack for the Macintosh.  Most important is the part about
  7. keeping the folder structure intact, and how to move a few files
  8. around.
  9.  
  10. For me, having done this a few times, steps 1-7 take less than five
  11. minutes.  Add to that an average compilation time of 25 minutes
  12. (without VISION_TABLES, see below) and a full build of NetHack from
  13. scratch doesn't take more than a lunch break.
  14.  
  15. 0)    Requirements:
  16.     - MPW C 3.2
  17.     - Mac with 68020 or better CPU (this is required to run MPW 3.2)
  18.     - 10 MB free disk (at least)
  19.     - 8 MB memory (using System 6, or a slimmed System 7)
  20.       More is quite preferable.
  21.     - About 7 minutes of time on a Quadra with a RAM disk that fits
  22.       the entire compilation.  Less than an hour for an SE/30 with
  23.       standard hard disk.
  24.     - Do NOT use virtual memory, or the compilation will quite possibly
  25.       take the whole weekend.  We're serious.
  26.  
  27. 1)    Move all source files onto your hard disk.  Make sure to keep the
  28.     folder structure the way it is.  You can skip the "tty" "X11" "amiga"
  29.     "msdos" "os2" and "vms" folders if you are hard pressed for space.
  30.     Also make sure the files are in native mac text format (i.e. ASCII
  31.     13 is used for newlines).
  32.  
  33. 2)    De-binhex the file :sys:mac:NHmake.hqx using Stuffit, Compact Pro,
  34.     tickle, or any other de-binhexer.  Move the resulting file
  35.     (Nethack.make) into the "top" folder (the one containing the
  36.     folders "src" "include" etc).
  37.  
  38. 3)    De-binhex the files :sys:mac:NHrez.hqx, :sys:mac:NHrsrc.hqx and
  39.     :sys:mac:NHsound.hqx. If there is no sound file, or you do not
  40.     want the sounds (they take up 200K in the final binary) you must
  41.     create an empty resource file called "Sounds.rsrc" in the folder
  42.     :sys:mac, using ResEdit.
  43.     The resulting files should be left in :sys:mac:
  44.  
  45. 4)    Edit the make file Nethack.make to set the Top variable.  If your top
  46.     folder is called "nh31" and is in the MPW folder, this is not needed.
  47.  
  48. 5)    Create two new folders in the top folder, named "Dungeon" and "Obj".
  49.  
  50. 6)    You may want to edit some of the options in :include:config.h to suit
  51.     your tastes.  However, using MPW, this file will self-configure for
  52.     the default Mac distribution.
  53.  
  54.     NOTE: The make file defines VISION_TABLES, and macconf.h sets
  55.     the option BRACES to match, so you should not concern yourself
  56.     with that option in config.h. However, compiling with the option
  57.     VISION_TABLES will generate a faster binary, at the expense of
  58.     the size of the application, and compilation time.
  59.  
  60.     Your MPW shell will need at least 7000K REAL MEMORY (TempMem
  61.     won't do) for this compile to work. If you don't have it, you
  62.     can try removing the VISION_TABLES option in the make file,
  63.     you will however still need around 3000K for the MPW shell.
  64.  
  65. 7)    Use BuildProgram on the make file. This is Cmd-B for most folks.
  66.     Sit back and relax. The linker will spew out a lot of warnings
  67.     about global data size (Error 34) but that's OK. If you don't
  68.     want the warnings, turn on -model far in the make file; this will
  69.     make a slightly less efficient program but gives no warnings.
  70.  
  71. 8)    When the build is done, a short melody is played, and the results are
  72.     in the Dungeon folder.  Enjoy!
  73.  
  74. 9)    If you want to make any changes to the dungeon compiler or the special
  75.     level compiler, you will need to edit the makefile to remove the
  76.     dependencies for dgn_comp.h and lev_comp.h.  You should then add 
  77.     dependencies for dgn_lex.c and lev_lex.c (output by lex) You
  78.     will also need dependencies for dgn_yacc.c and lev_yacc.c (Output
  79.     of yacc).  All four of these files should end up in the Top:sys:share
  80.     folder.  Finally, the y.tab.h output from yacc should end up in
  81.     the include folder as dgn_comp.h/lev_comp.h.
  82.     
  83.  
  84. 10)    If, heaven forbid, you experience any configuration problems or make
  85.     errors, try to fix it yourself (there are several READMEs and the
  86.     like you can check), but be sure to save a copy of the original files
  87.     if you change anything.  There should be no problems if you use the
  88.     correct versions etc. as per step 0 but you never know.  As always,
  89.     turn off all INITs and re-boot if you have any problems, and they
  90.     might go away.
  91.  
  92.     If you experience any bugs, please mail them to the bug report address
  93.     nethack-bugs@linc.cis.upenn.edu
  94.     Be sure to include what computer you use, how it is configured, what
  95.     version of MPW and C and the headers you use, where you got the
  96.     NetHack code etc. etc.
  97.  
  98. 11)    This code is provided "as is" free of charge, and no warranty of any
  99.     kind can or will cover it.  Use at your own risk.  This code is
  100.     protected under copyright law, and may only be re-distributed under
  101.     the terms of the NetHack license also found in this package, or
  102.     otherwise with the authors' permission.  (If the license is missing,
  103.     mail the bug report address for a copy.)
  104.